Skip to content

docs: update bazel README to include virtualenv#5864

Merged
htuch merged 6 commits intoenvoyproxy:masterfrom
fcfort:docs3
Feb 8, 2019
Merged

docs: update bazel README to include virtualenv#5864
htuch merged 6 commits intoenvoyproxy:masterfrom
fcfort:docs3

Conversation

@fcfort
Copy link
Contributor

@fcfort fcfort commented Feb 6, 2019

Description: Using buildifier failed without virtualenv so noting in the bazel README file. Also did some cleanup of the ordered list to always use "1.", see https://guides.github.com/features/mastering-markdown/#syntax.
Risk Level: Low
Testing: image
Docs Changes: N/A
Release Notes: N/A

Signed-off-by: Frank Fort <ffort@google.com>
Signed-off-by: Frank Fort <ffort@google.com>
Signed-off-by: Frank Fort <ffort@google.com>
Signed-off-by: Frank Fort <ffort@google.com>
bazel/README.md Outdated
and also for [Buildifer](https://github.com/bazelbuild/buildtools) which is used for formatting bazel BUILD files.
1. `go get -u github.com/bazelbuild/buildtools/buildifier` to install buildifier. You may need to set `BUILDIFIER_BIN` to `$GOPATH/bin/buildifier`
in your shell for buildifier to work.
1. `sudo apt-get install virtualenv` to install virtualenv (needed by `buildifier`).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not list this above in the apt-get list for (2)?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly to distinguish things needed for building envoy vs developer tooling. It might even be clearer to fork out this section into things needed for building Envoy vs things needed for contributing to Envoy

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, we don't really have this separation today, e.g. clang-format is in the first list. Since this section is titled "Quick start Bazel for developers", it's probably best to just put all the developer tooling in the main list.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

@htuch htuch self-assigned this Feb 6, 2019
Signed-off-by: Frank Fort <ffort@google.com>
htuch
htuch previously approved these changes Feb 7, 2019
Copy link
Member

@htuch htuch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@htuch htuch merged commit 0c7d4a0 into envoyproxy:master Feb 8, 2019
@fcfort fcfort deleted the docs3 branch February 27, 2019 16:31
fredlas pushed a commit to fredlas/envoy that referenced this pull request Mar 5, 2019
Using buildifier failed without virtualenv so noting in the bazel README file. Also did some cleanup of the ordered list to always use "1.", see https://guides.github.com/features/mastering-markdown/#syntax.

Risk Level: Low

Signed-off-by: Frank Fort <ffort@google.com>
Signed-off-by: Fred Douglas <fredlas@google.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants